Host container for render states for 3D rendering. More...

#include <kanzi/core.ui/graphics3d/render_entry_3d.hpp>

Inheritance diagram for kanzi::RenderEntry3D:

Classes
class	MorphHandles
	Cached morph handles. More...

Public Types
using	BindingRuntimeContainer
	Binding runtime container.

using	MorphHandlesPtr
	Unique pointer type for MorphHandles.

using	ReplacementBindingContainer
	Replacement binding container.

Public Types inherited from kanzi::VariableBindingHost
using	BindingRuntimeConstIterator
	Const iterator for binding runtimes.

using	BindingRuntimeContainer
	Binding runtime container.

using	BindingRuntimeIterator
	Iterator for binding runtimes.

using	BindingTargetMapping
	Binding target mapping.

Public Member Functions
MorphHandles &	acquireMorphHandles ()
	Gets the morph handles structure.

void	applyFixedUniforms (Renderer3D &renderer)
	Apply fixed uniforms before rendering.

bool	applyRenderState (Renderer3D &renderer)
	Apply the internal render state for rendering.

void	bindGeometry (Renderer3D &renderer)
	Bind the contained geometry for rendering.

bool	bindRenderState (Renderer3D &renderer)
	Bind the contained render state for rendering.

size_t	getIndex () const
	Gets the associated index within the node.

MaterialSharedPtr	getMaterial () const
	Gets the associated material.

Mesh *	getMesh () const
	Gets the associated mesh.

Node3D *	getNode () const
	Gets the associated node.

RenderPass &	getRenderPass ()
	Gets the associated node.

GlRenderState &	getRenderState ()
	Gets the internal render state.

bool	matches (const Node3D &node, size_t clusterIndex, MaterialSharedPtr material, Mesh *mesh)
	Tests if the render entry matches given settings.

void	updateBindingsWithFixedUniformInputs ()
	Execute all bindings needing manual execution.

Public Member Functions inherited from kanzi::VariableBindingHost
void	addAvailableVariableSource (AbstractBindingVariableSource &variableSource)
	Add a variable source to the list of available sources.

void	addBindingRuntime (AbstractBindingRuntimeSharedPtr bindingRuntime)
	Adds a binding runtime to the list of binding runtimes.

void	addVariableTarget (VariableBindingTargetRuntime &targetRuntime)
	Adds variable binding target runtime into the variable host.

BindingRuntimeIterator	beginBindingRuntimes ()
	Gets an iterator to the beginning of binding runtimes.

BindingRuntimeConstIterator	beginBindingRuntimes () const
	Gets an iterator to the beginning of binding runtimes.

BindingRuntimeIterator	endBindingRuntimes ()
	Gets an iterator to the end of binding runtimes.

BindingRuntimeConstIterator	endBindingRuntimes () const
	Gets an iterator to the end of binding runtimes.

BindingRuntimeIterator	endFixedRuntimes ()
	Gets an iterator to the end of fixed binding runtimes.

BindingRuntimeConstIterator	endFixedRuntimes () const
	Gets an iterator to the end of fixed binding runtimes.

VariableBindingTargetRuntime *	getVariableBindingTargetRuntime (AbstractPropertyType propertyType)
	Gets an existing variable binding target runtime based on a property type.

void	removeAvailableVariableSource (AbstractBindingVariableSource &variableSource)
	Remove a variable source from the list of available sources.

void	removeBindingRuntime (AbstractBindingRuntime &bindingRuntime)
	Removes a binding runtime.

void	removeVariableTarget (VariableBindingTargetRuntime &targetRuntime)
	Removes a variable binding target from the variable host.

	~VariableBindingHost ()
	Destructor.

Static Public Member Functions
static unique_ptr< RenderEntry3D >	create (RenderPass &renderPass, Node3D &node, size_t index, MaterialSharedPtr material, Mesh *mesh)
	Creates a new render entry.

Protected Member Functions
void	initializeRenderState (MaterialSharedPtr sharedMaterial)
	Initialize the internal state.

	RenderEntry3D (RenderPass &renderPass, Node3D &node, size_t index, MaterialSharedPtr material, Mesh *mesh)
	Constructor.

Protected Attributes
BindingRuntimeContainer::const_iterator	m_endFixedRuntimes
	Iterator to the binding runtimes, to the last place there are fixed operations.

size_t	m_index
	Source element (i.e.

Mesh *	m_mesh
	Mesh being rendered.

MorphHandlesPtr	m_morphHandles
	Morph handles for this render entry.

Node3D *	m_node
	Pointer to source node.

RenderPass &	m_renderPass
	Base render pass.

GlRenderState	m_renderState
	Contained render state.

Detailed Description

Host container for render states for 3D rendering.

Used by render passes when drawing 3D objects. Contains the render state, references to associated node and render pass, and binding runtimes.

Since: Kanzi 3.9.0

Member Typedef Documentation

◆ MorphHandlesPtr

using kanzi::RenderEntry3D::MorphHandlesPtr

Unique pointer type for MorphHandles.

Since: Kanzi 3.9.7

◆ BindingRuntimeContainer

using kanzi::RenderEntry3D::BindingRuntimeContainer

Binding runtime container.

◆ ReplacementBindingContainer

using kanzi::RenderEntry3D::ReplacementBindingContainer

Replacement binding container.

Constructor & Destructor Documentation

◆ RenderEntry3D()

kanzi::RenderEntry3D::RenderEntry3D	(	RenderPass &	renderPass,
		Node3D &	node,
		size_t	index,
		MaterialSharedPtr	material,
		Mesh *	mesh )

explicitprotected

Constructor.

Parameters

renderPass	Owning render pass.
node	Node associated.
index	Index within the node.
material	Material associated.
mesh	Mesh to use.

Since: Kanzi 3.9.1 constructor changed to explicit.

Member Function Documentation

◆ create()

static unique_ptr< RenderEntry3D > kanzi::RenderEntry3D::create	(	RenderPass &	renderPass,
		Node3D &	node,
		size_t	index,
		MaterialSharedPtr	material,
		Mesh *	mesh )

static

Creates a new render entry.

Parameters

renderPass	Owning render pass.
node	Node associated.
index	Index within the node.
material	Material associated.
mesh	Mesh being rendered.

◆ updateBindingsWithFixedUniformInputs()

void kanzi::RenderEntry3D::updateBindingsWithFixedUniformInputs ( )

Execute all bindings needing manual execution.

Used internally by the binding functions.

◆ applyRenderState()

bool kanzi::RenderEntry3D::applyRenderState ( Renderer3D & renderer )

Apply the internal render state for rendering.

Used internally by the binding functions.

Parameters

renderer Renderer to use.

◆ applyFixedUniforms()

void kanzi::RenderEntry3D::applyFixedUniforms ( Renderer3D & renderer )

Apply fixed uniforms before rendering.

Used internally by the binding functions.

Parameters

renderer Renderer to use.

◆ bindRenderState()

bool kanzi::RenderEntry3D::bindRenderState ( Renderer3D & renderer )

Bind the contained render state for rendering.

Applies any bindings needing manual execution, then binds the render state, then applies fixed uniforms. This does not bind the contained geometry for rendering.

Parameters

renderer Renderer to use.

Returns: True if the shader program to bind was bound correctly.

◆ bindGeometry()

void kanzi::RenderEntry3D::bindGeometry ( Renderer3D & renderer )

Bind the contained geometry for rendering.

The contained render state should be bound before calling this function.

Parameters

renderer Renderer to use.

◆ matches()

bool kanzi::RenderEntry3D::matches	(	const Node3D &	node,
		size_t	clusterIndex,
		MaterialSharedPtr	material,
		Mesh *	mesh )

Tests if the render entry matches given settings.

Parameters

node	Node to compare.
clusterIndex	Cluster index to compare.
material	Material to compare.
mesh	Mesh to compare.

◆ getRenderPass()

RenderPass & kanzi::RenderEntry3D::getRenderPass ( )

inline

Gets the associated node.

Returned render pass cannot be invalid, since the association is owned by it.

Returns: Render pass.

◆ getNode()

Node3D * kanzi::RenderEntry3D::getNode ( ) const

inline

Gets the associated node.

Returns: Shared pointer to node. May be invalid if node has been destroyed.

◆ getIndex()

size_t kanzi::RenderEntry3D::getIndex ( ) const

inline

Gets the associated index within the node.

Returns: Index.

◆ getMaterial()

MaterialSharedPtr kanzi::RenderEntry3D::getMaterial ( ) const

inline

Gets the associated material.

Returns: material.

◆ getMesh()

Mesh * kanzi::RenderEntry3D::getMesh ( ) const

inline

Gets the associated mesh.

Returns: mesh.

◆ getRenderState()

GlRenderState & kanzi::RenderEntry3D::getRenderState ( )

inline

Gets the internal render state.

Returns: Reference to the render state.

◆ acquireMorphHandles()

MorphHandles & kanzi::RenderEntry3D::acquireMorphHandles ( )

inline

Gets the morph handles structure.

If the structure does not exist, creates it.

Returns: Reference to the morph handles.

Since: Kanzi 3.9.7

◆ initializeRenderState()

void kanzi::RenderEntry3D::initializeRenderState ( MaterialSharedPtr sharedMaterial )

protected

Initialize the internal state.

Attach render state to material. Create binding runtimes for render value bindings and attach them.

Parameters

sharedMaterial Material to attach to.

Member Data Documentation

◆ m_renderPass

RenderPass& kanzi::RenderEntry3D::m_renderPass

protected

Base render pass.

The render pass owns the association, so this reference can never be invalid.

◆ m_node

Node3D* kanzi::RenderEntry3D::m_node

protected

Pointer to source node.

If this pointer is marked as nullptr, the entry is invalid.

◆ m_index

size_t kanzi::RenderEntry3D::m_index

protected

Source element (i.e.

cluster) index for the node. Each renderable element or cluster has its own render state association.

◆ m_mesh

Mesh* kanzi::RenderEntry3D::m_mesh

protected

Mesh being rendered.

This member will be replaced with vertex- and index buffers and matrix palette in the future.

◆ m_morphHandles

MorphHandlesPtr kanzi::RenderEntry3D::m_morphHandles

protected

Morph handles for this render entry.

Kanzi creates the handles only if it renders the morph meshes using this entry.

Since: Kanzi 3.9.7

◆ m_renderState

GlRenderState kanzi::RenderEntry3D::m_renderState

protected

Contained render state.

◆ m_endFixedRuntimes

BindingRuntimeContainer::const_iterator kanzi::RenderEntry3D::m_endFixedRuntimes

protected

Iterator to the binding runtimes, to the last place there are fixed operations.

The documentation for this class was generated from the following file:

kanzi/core.ui/graphics3d/render_entry_3d.hpp

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ MorphHandlesPtr

◆ BindingRuntimeContainer

◆ ReplacementBindingContainer

Constructor & Destructor Documentation

◆ RenderEntry3D()

Member Function Documentation

◆ create()

◆ updateBindingsWithFixedUniformInputs()

◆ applyRenderState()

◆ applyFixedUniforms()

◆ bindRenderState()

◆ bindGeometry()

◆ matches()

◆ getRenderPass()

◆ getNode()

◆ getIndex()

◆ getMaterial()

◆ getMesh()

◆ getRenderState()

◆ acquireMorphHandles()

◆ initializeRenderState()

Member Data Documentation

◆ m_renderPass

◆ m_node

◆ m_index

◆ m_mesh

◆ m_morphHandles

◆ m_renderState

◆ m_endFixedRuntimes